home *** CD-ROM | disk | FTP | other *** search
/ APDL Eductation Resources / APDL Eductation Resources.iso / programs / electronic / rlab / !RLaB / misc / plhelp / plot < prev    next >
Encoding:
Text File  |  1995-02-04  |  3.6 KB  |  115 lines
  1. plot:
  2.  
  3. Synopsis: RLaB graphics interface
  4.  
  5. Syntax: plot ( A )
  6.     plot ( A , KEY )
  7.  
  8. Description:
  9.  
  10.     Plot A in the current sub-plot in the current plot-window.  A
  11.     can be a matrix, in which case the columns are plotted against
  12.     the 1st column. If A is a column vector, then the column is
  13.     plotted versus the row values. A can also be a list, in which
  14.     case each matrix in the list is plotted (this is a good way to
  15.     plot data with different scales). If A is a list the elements
  16.     of the list with names that can be converted to decimal are
  17.     plotted first, in ascending numerical order. the list elements
  18.     with names that cannot be converted to decimal are plotted
  19.     last, in ascending string order.
  20.  
  21.     KEY is an optional argument denoting the column to use as the
  22.     independent variable. 
  23.  
  24.         if KEY > 0    Use KEY as the independent variable on
  25.                 the X-axis.
  26.  
  27.         if KEY = 0    Plot all columns of A against the row
  28.                 indices. 
  29.  
  30.         if KEY < 0    Use abs(KEY) as the independent
  31.                 variable on the Y-axis.
  32.  
  33.     Plot and its related functions define a user interface to the
  34.     Plplot graphics library. The PLPLOT graphics library can
  35.     produce output on X-windows, DOS, OS/2, Amiga, Tektronix,
  36.     PostScipt, and other output devices.
  37.  
  38.     The plot interface operation is based upon two important
  39.     concepts: the current plot-window, and the current sub-plot.
  40.  
  41.     The current plot-window is a valid concept only if selected
  42.     output device supports multiple windows (X-windows for
  43.     example).
  44.  
  45.     The current sub-plot should be available for all devices,
  46.     since sub-plots are individual plots that co-exist on the same
  47.     page, or display.
  48.  
  49.     Invoking pstart() will create a plot-window. The newly created
  50.     plot-window will be the current plot-window. If more than one
  51.     plot-window has been created, then the current window can be
  52.     selected with the pwin() function. The current plot-window can
  53.     be closed with pclose(). All of the plot-windows can be closed
  54.     with pend().
  55.  
  56.     Each plot-window can be divided up into more than 1 sub-plot
  57.     (the default). The number and arrangement of the sub-plots is
  58.     specified by the user when pstart() is invoked. All plot
  59.     manipulation functions, such as plstyle(), plgrid(), xlabel(),
  60.     etc... work on the current sub-plot. When plot() is used the
  61.     current sub-plot is created, after which the current sub-plot
  62.     is incremented. The sub-plots are incremented to the right,
  63.     and down (the same way you read an English language book).
  64.  
  65.     The following is a list of the plot related functions.
  66.  
  67.     pstart ( NCOL, NROW, DEVICE )
  68.     pwin ( NWIN )
  69.     showpwin ( )
  70.     pclose ( )
  71.     pend ( )
  72.  
  73.     plot ( DATA )
  74.     plhist ( DATA )
  75.     plhistx ( DATA )
  76.     plerry ( X, Y, Ymin, Ymax )
  77.     xlabel ( XLABEL )
  78.     ylabel ( YLABEL )
  79.     ptitle ( PTITLE )
  80.     plimits ( XMIN, XMAX, YMIN, YMAX, ZMIN, ZMAX )
  81.     plgrid ( GRID_STY_X, GRID_STY_Y )
  82.     plgrid3 ( GRID_STY_X, GRID_STY_Y, GRID_STY_Z )
  83.     plaxis ( X_STR, Y_STR )
  84.     plstyle ( PSTYLE )
  85.     plaspect ( ASPECT )
  86.     subplot ( N )
  87.  
  88.     plot3 ( L3D )
  89.     plmesh ( L3D )
  90.     plcont ( CL )
  91.     zlabel ( ZLABEL )
  92.     plalt ( ALT )
  93.     plaz ( AZ )
  94.  
  95.     plfont ( FONT )
  96.     plwid ( WIDTH )
  97.     plptex ( TEXT, X, Y, DX, DY, JUST )
  98.     plegend ( DESCRIPTION )
  99.  
  100.     plprint ( FILENM, DEVICE )
  101.     replot ( )
  102.  
  103.     plscol0 ( COLOR, RED, GREEN, BLUE )
  104.     
  105.     The high-level plot functions are implemented in RLaB. The
  106.     low-level plot functions mimic the Plplot application
  107.     programming interface (API). This particular method of
  108.     implementation was chosen to allow users maximum flexibility
  109.     when adding new or improved plot features.
  110.  
  111.     The low-level Plplot functions all begin with a `_'
  112.     character. One low-level function of use to some is
  113.     _plflush. This function takes no arguments, and flushes the
  114.     plot buffer, if the plot device supports that function.
  115.